package cn.tedu.truetaste.service;

import cn.tedu.truetaste.pojo.dto.UserAddNewDTO;
import cn.tedu.truetaste.pojo.dto.UserUpdateDTO;
import cn.tedu.truetaste.pojo.vo.UserListItemVO;
import cn.tedu.truetaste.pojo.vo.UserStandardVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * 用户业务接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
@Transactional
public interface IUserService {

    /**
     * 添加用户
     *
     * @param userAddNewDTO 用户
     */
    void addNew(UserAddNewDTO userAddNewDTO);

    /**
     * 删除用户
     *
     * @param id 用户id
     */
    void delete(Long id);

    /**
     * 修改用户详情
     *
     * @param id             被修改的用户id
     * @param userUpdateDTO 封装了新数据的对象
     */
    void updateInfoById(Long id, UserUpdateDTO userUpdateDTO);

    /**
     * 根据openId查询用户详情
     *
     * @param openId openId
     * @return 匹配的用户详情，如果没有匹配的数据，将抛出异常
     */
    UserStandardVO getStandardByOpenId(String openId);

    /**
     * 根据用户id查询用户详情
     *
     * @param id 用户id
     * @return 匹配的用户详情，如果没有匹配的数据，将抛出异常
     */
    UserStandardVO getStandardById(Long id);

    /**
     * 查询用户数据列表
     *
     * @return 用户数据列表
     */
    List<UserListItemVO> list();

}
